home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / rapc100.zip / RAPC.DOC < prev    next >
Text File  |  1991-02-24  |  5KB  |  103 lines
  1. RA Personell Checker 1.00c
  2. Copyright 1990 Motor City Software
  3. Written by John Parlin
  4. All rights reserved
  5.  
  6. Well, I've tried just about everything and have thrown my hands into the air
  7. in dispair.  RemoteAccess does not automatically format a user's phone number
  8. when it is entered.  This is understandable since not everyone uses a USA
  9. style phone number format.  But here in the USA, it's frustrating trying to
  10. get users to enter a phone number using the format that CBV's can understand.
  11.  
  12. In addition, RA 1.00 offers the new Handle and Birthdate fields.  This is
  13. great except if you're upgrading from RA 0.04 to 1.00.  RA will ask a new
  14. user for this additional information, if the Sysop specifies but RA doesn't
  15. ask for this information if the user was in the user file prior to the Sysop
  16. upgrading to 1.00.  RAPC will obtain this information if the Sysop specifies
  17. it.
  18.  
  19. RAPC will check a user's phone numbers for the format ###-###-####.  If
  20. a phone number is not in this format, it will prompt the user for it and it
  21. will automatically format the number much like QuickBBS did.  If the files
  22. VPHONE.TXT or DPHONE.TXT are found, RAPC will display them to the screen
  23. before prompting the user for a valid number.  These are ASCII text files
  24. which you can create explaining why the user is being prompted for phone
  25. number input again.  VPHONE.TXT is displayed prior to prompting for a voice
  26. phone number and DPHONE.TXT is displayed prior to prompting for a data phone
  27. number.
  28.  
  29. RAPC will also compare user phone numbers with PHONENUM.CTL.  Be CERTAIN
  30. that your PHONENUM.CTL file is in the correct format.  Some folks assume that
  31. if they have a line containing "999" in their PHONENUM.CTL file, that
  32. 999-#### will not be allowed.  This is not true.  If you wish to disallow
  33. a given prefix, it should be entered in PHONENUM.CTL as "999-".  RAPC looks
  34. for the embedded string and if it finds it, it will re-prompt the user for a
  35. valid phone number.
  36.  
  37. If RAPC determines that a number is not allowed (through comparison of the
  38. PHONENUM.CTL file), the file IPHONE.TXT (intercepted phone number) will
  39. be displayed, if found.  If not found, a short message will be displayed.
  40.  
  41. If you specify, RAPC will check the user's record to see if they have
  42. selected a handle.  If no handle is specified, RAPC will display the text
  43. file HANDLE.TXT (if it exists) and will then prompt the user to select a
  44. handle.  Handles are checked against TRASHCAN.CTL for embedded, unwanted
  45. words.  Handles are also checked against the user file.  The user will not
  46. be allowed to select a handle that someone else is currently using.  RAPC
  47. will also not allow the handle SYSOP to be used.
  48.  
  49. If you specify, RAPC will check the user's record to see if they have
  50. entered their birthdate.  If no birthdate information is specified, RAPC
  51. will display the text file BDAY.TXT (if it exists) and will then prompt the
  52. user to enter their birthdate.  RAPC will automatically format the birthdate
  53. to proper specs and will also check for date validity.
  54.  
  55. To use RAPC, create a type 7 auto-execute menu entry on your top menu.
  56. Make it the first line with a semicolon in the display field.  Use a flag in
  57. the menu entry so that it will only execute for a new user.  Be sure to define
  58. in RACONFIG, new user information, that this flag be turned on for new users.
  59.  
  60. In the optional data field of the type 7, put RAPC.EXE followed by the
  61. flag which you would like to have turned OFF after execution, and any
  62. other command line parameters as listed below.
  63.  
  64.  
  65. Command line examples:
  66.  
  67.         RAPC.EXE A1             Run RAPC checking phone numbers only.
  68.                                 Turn the A1 flag OFF after execution.
  69.  
  70.         RAPC.EXE A1 /H          Run RAPC checking phone numbers and Handle
  71.                                 information.  Turn the A1 flag OFF after
  72.                                 execution.
  73.  
  74.         RAPC.EXE A1 /H /B       Run RAPC checking phone numbers, Handle and
  75.                                 Birthdate information.  Turn the A1 flag
  76.                                 OFF after execution.
  77.  
  78. Next, edit the ASCII text file RAPC.CFG.  This file should contain only
  79. one line.  That line should be the path to your RA *.CTL files.  For
  80. example, if my PHONENUM.CTL and my TRASHCAN.CTL files are in my \RA directory,
  81. the RAPC.CFG file would look like this:
  82.  
  83. \RA\
  84. \RA\MSGBASE\
  85.  
  86. This example shows that the *.CTL files are in the \RA\ directory and the
  87. USERSXI.BBS file is in the \RA\MSGBASE\ directory.
  88.  
  89. RAPC needs to find this file.  Only the first two lines are read.  All other
  90. lines are ignored.  The reason I threw this in here is for those few who would like
  91. to use RAPC on a multi-line setup.
  92.  
  93. That's all there is to it.  Just put RAPC.EXE and RAPC.CFG in your RA directory
  94. where EXITINFO.BBS and DORINFO1.DEF are created.
  95.  
  96. NOTE:  This program utilizes RemoteAccess 1.00 data structures.  No
  97.        conversion programs are needed and none should be used.
  98.  
  99. If you find this program useful (meaning, if you use it) great.  Please pass
  100. it around.  There is no charge or fee for the use of this program.
  101.  
  102.  
  103.